Vagrant + Chef ベースのWordPress Theme / Plugin 開発環境「VCCW」

VCCWはVagrant + Chef ベースのWordpressのプラグイン / テーマ開発環境です。VagrantとVirtualBoxをインストールすればコマンド数回で仮想マシンが立ち上がり便利なWordpress開発環境ができあがります。ローカルのXAMPPやLAMPを卒業したい、そんな方にお勧めです。

動作環境

VCCWはVagrant 1.5以上、VirtualBox 4.3以上が必要です。コマンドラインで操作することになるので、あまりコマンドラインを使った経験のないデザイナーさんには敷居が高いかもしれません。

VCCWでできること

公式サイトの箇条書きを抜き出してきただけですが、下記のようなことができます。設定ファイル（Vagrantfile）を書き換えるだけで変更もできます。

• コンフィグファイルによる設定変更（Vagrantfile）
  • マルチサイト
  • 管理画面のSSL接続
  • サブディレクトリインストール（http://wordpress.local/wp/）
• カスタマイズ可能なURL（http://wordpress.local/）
• デバッグモード（defalt enabled）
• SSL（defalt enabled）
• 自動インストール
  • プラグインのアクティベート
• Unitテストデータのインポート
• ツールのプリインストール
  • WP-CLI
  • Grunt
  • Composer
  • WordPress i18n Tools
  • PHPUnit
    • WordPress Unit Tests
  • PHP_CodeSniffer
    • WordPress Coding Standards for PHP_CodeSniffer
  • WordPressフォルダのシェア（ホスト・ゲストOS間）

環境構築

公式に掲載されている通りですが、大まかな流れはこんな感じです。

1. VirtualBoxのインストール
2. Vagrantのインストール
3. ホスト設定を書き換えるvagrant-hostsupdaterのインストール
4. VCCW本体のクローン
5. テスト用ディレクトリの作成
6. Vagrantfile（設定ファイル）のコピーと修正
7. Vagrantの初期構築と立ち上げ
8. ブラウザで確認

それでは進めていましょう。

VirtualBoxとVagrantのインストール

VirtualBoxとVagrantのインストールはどちらもインストーラーが用意されているので簡単です。

• VirtualBox Downloads
• Vagrant Downloads

vagrant-hostsupdater pluginのインストール

vagrant-hostsupdaterは仮想マシン（ゲストOS）を起動した際に、ホストOS（つまりは自身のMac/Windows OS）のHostsファイルにゲストOSのホスト名やIPを追加・削除しホストOSのブラウザからアクセスできるようにしてくれるプラグインです。

vagrant-hostsupdaterはroot権限を求められる処理を行います。ですので$ vagrant upを行った際はパスワードを求められます。一番注意しなければならないのは必ず$ vagrant haltで終了しないとHostsの情報が削除されません。注意しましょう。

$ vagrant plugin install vagrant-hostsupdater
Installing the 'vagrant-hostsupdater' plugin. This can take a few minutes...
Installed the plugin 'vagrant-hostsupdater (0.0.11)'!

githubからVCCWをクローンする

続いて、VCCWをローカルに落としてきましょう。適当にプロジェクトフォルダを作成し、その中でクローンするのが良いと思います。

$ cd vccw.example/
$ git clone git@github.com:miya0001/vccw.git
...
$ cd vccw/

クローンされたVCCW

クローンできたらvccwのディレクトリに何が入っているかチェックしておきましょう。この中で実際に触るのはVagrantfile.sampleのみです。

vccw/
├── README.md
├── Vagrantfile.sample
├── cookbooks/
└── site-cookbooks/

VagrantfileをVagrantfile.sampleから作る

Vagrantfile.sampleはVagrantfileを作るためのひな形です。コピーしてVagrantfileを作ります。

$ cp Vagrantfile.sample Vagrantfile

Vagrantfileを修正

デフォルトのままでも立ち上がりますが、そのままだと英語版がインストールされます。そこでWP_LANG = "en_US" # WordPress locale (e.g. ja)の部分をWP_LANG = "ja" # WordPress locale (e.g. ja)に変更しましょう。もちろん読めばすぐにわかるような設定ばかりなので必要に応じて変更しましょう。

# encoding: utf-8
# vim: ft=ruby expandtab shiftwidth=2 tabstop=2

VAGRANTFILE_API_VERSION = "2"
Vagrant.require_version ">= 1.5"

#
# Configuration for the WordPress
#

VM_BOX               = "chef/centos-6.5-i386" # for 32bit
# VM_BOX               = "chef/centos-6.5" # for 64bit

WP_VERSION           = 'latest' # latest or 3.4 or later or http(s):// URL to zipfile
WP_LANG              = "ja_JP" # WordPress locale (e.g. ja)

WP_HOSTNAME          = "wordpress.local" # e.g example.com
WP_IP                = "192.168.33.10" # host ip address

WP_TITLE             = "Welcome to the Vagrant" # title
WP_ADMIN_USER        = "admin" # default user
WP_ADMIN_PASS        = "admin" # default user's password

WP_DB_PREFIX         = 'wp_' # Database prefix
WP_DB_HOST           = 'localhost' # or WP_IP and other
WP_DB_NAME           = 'wordpress'
WP_DB_USER           = 'wordpress'
WP_DB_PASS           = 'wordpress'

WP_DEFAULT_PLUGINS   = %w(theme-check plugin-check dynamic-hostname) # default plugins
WP_DEFAULT_THEME     = '' # e.g. twentythirteen

WP_DIR               = '' # e.g. /wp or wp or other
WP_IS_MULTISITE      = false # enable multisite when true
WP_FORCE_SSL_ADMIN   = false # enable force ssl admin when true
WP_DEBUG             = true # enable debug mode
WP_SAVEQUERIES       = false # save the database queries to an array
WP_THEME_UNIT_TEST   = false # automatic import theme unit test data

WP_ALWAYS_RESET      = true # always reset database

WP_CHEF_COOKBOOKS_PATH = File.dirname(__FILE__) # path to the cookbooks (e.g. ~/vccw)

if WP_LANG === 'ja' then
  WP_THEME_UNIT_TEST_DATA_URI = 'https://raw.githubusercontent.com/jawordpressorg/theme-test-data-ja/master/wordpress-theme-test-date-ja.xml'
else
  WP_THEME_UNIT_TEST_DATA_URI = 'https://wpcom-themes.svn.automattic.com/demo/theme-unit-test-data.xml'
end

# end configuration

仮想マシンの立ち上げ

初回起動時はChefが走り環境構築が行われているので5分程度の時間がかかります。

$ vagrant up
Bringing machine 'default' up with 'virtualbox' provider...
==> default: Importing base box 'chef/centos-6.5-i386'...
==> default: Matching MAC address for NAT networking...
==> default: Checking if box 'chef/centos-6.5-i386' is up to date...

ブラウザからアクセスする

それでは、ブラウザからサイトにアクセスしてみましょう。URLを変更していなければhttp://wordpress.local/でアクセスできます。ブラウザでアクセスできていれば構築完了です。

仮想マシンの終了

仮想マシンの終了は忘れずに行いましょう。終了時もHostsの変更が行われroot権限が必要なのでパスワード入力が求められます。

$ vagrant halt
==> default: Attempting graceful shutdown of VM...
==> default: Removing hosts
Password:

ローカル環境を汚さずにこれだけ早く環境構築できるのはとても便利ですね。以上、VCCWの紹介でした。

この記事はVagrant + Chef ベースのWordpress Theme / Plugin 開発環境「VCCW」の転載です。

エラーが起こったら

起動中に怒られたらこちらを参考にしてみてください。

• vagrant up が Permission denied でおこられた理由